home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d6 / formfill.arc / FILL.DOC < prev    next >
Text File  |  1990-07-17  |  32KB  |  399 lines

  1.                              |                                                 
  2.                              |                                                 
  3.                              |                                                 
  4.                              |                                                 
  5.                              |                                                 
  6.                              |                                                 
  7.                              |                                                 
  8.                              |                                                 
  9.                              |                                                 
  10.                              |      FormFill                                   
  11.                              |                                                 
  12.                              |      Form Filling System                        
  13.                              |                                                 
  14.                              |      ---------------------                      
  15.                              |                                                 
  16.                              |      (C) 1988-90 by                             
  17.                              |                                                 
  18.                              |      R.MacLean                                  
  19.                              |                                                 
  20.                              |                                                 
  21.                              |                                                 
  22.                              |                                                 
  23.                              |                                                 
  24.                              |                                                 
  25.                              |                                                 
  26.                              |                                                 
  27.                              |                                                 
  28.                              |                                                 
  29.                              |                                                 
  30.                              |                                                 
  31.                              |                                                 
  32.                              |                                                 
  33.                              |                                                 
  34.                              |                                                 
  35.                              |                                                 
  36.                              |      FormGen Corporation                        
  37.                              |      13 Holland Drive                           
  38.                              |      Bolton, Ontario, Canada                    
  39.                              |      L7E 1G4                                    
  40.                              |                                                 
  41.                              |      (416) 857-0022                             
  42.                              |                                                 
  43.                              |                                                 
  44.                              |                                                 
  45.                              |                                                 
  46.                              |                                                 
  47.                              |                                                 
  48.                              |                ---------                        
  49.                              |         ------|--       |              (tm)     
  50.                              |      --|         |      |------------------     
  51.                              |        |    -----|---   |  Association of       
  52.                              |        |   |         |--   Shareware            
  53.                              |         ---|    O    |     Professionals        
  54.                              |      ------|    |    |---------------------     
  55.                              |             ---------      MEMBER               
  56.                              |                                                 
  57.                              |                                                 
  58.                              |                                                
  59. FormFill                           Shareware                        Quick Doc  
  60.                                    =========                                   
  61.     |                                                                          
  62.     | "Shareware" is a term used to describe a system for distribution         
  63.     | of software.  Under the shareware concept, software may be freely        
  64.     | copied and passed along to others, or distributed through bulletin       
  65.     | board systems, etc.                                                      
  66.     |                                                                          
  67.     | As a recipient of a shareware program, you may use the software          
  68.     | for a short trial period to determine if it meets your needs. If         
  69.     | it does, you pay the registration fee.  By paying the fee, you are       
  70.     | granted the right to retain the software for your use.  If the           
  71.     | software is not suitable then you may discard it.                        
  72.     |                                                                          
  73.     | The shareware system provides substantial benefits the computing         
  74.     | community (of which YOU are a member):                                   
  75.     |                                                                          
  76.     | 1) You get to try out the software BEFORE you buy it so you know         
  77.     |    exactly what you're buying.                                           
  78.     |                                                                          
  79.     | 2) Shareware is substantially less expensive than most commercial        
  80.     |    programs.  You don't pay for costly marketing programs and            
  81.     |    fancy packaging.                                                      
  82.     |                                                                          
  83.     | 3) You get access to a MUCH broader base of available programs.          
  84.     |    Thousands of excellent programs have been written by expert           
  85.     |    programmers who would never consider marketing commercially.          
  86.     |    Through the concept of shareware, these people their programs         
  87.     |    available to the community.  Usually, all they ask in return          
  88.     |    is a small fee to reward them for the time and effort they've         
  89.     |    put into the program.                                                 
  90.     |                                                                          
  91.     | The system is based entirely on the honour system, and generally         
  92.     | works quite well.  (Most people are honest and wouldn't violate          
  93.     | the trust placed in them by the author of the software.)                 
  94.     |                                                                          
  95.     | Shareware is NOT free software - the author counts on your integrity.    
  96.     | Please register using the form the the end of this manual.               
  97.     |                                                                          
  98.     | You are encouraged to copy this software and pass it along to            
  99.     | others who may be interested in using it.                                
  100.     |                                                                          
  101.     | This program is produced by a member of the Association of Shareware     
  102.     | Professionals (ASP).  ASP wants to make sure that the shareware          
  103.     | principle works for you.  If you are unable to resolve a shareware       
  104.     | related problem with an ASP member by contacting the member directly,    
  105.     | ASP may be able to help.  The ASP Ombudsman can help you resolve a       
  106.     | dispute or problem with an                                               
  107.     | ASP member, but does not                                                 
  108.     | provide  technical support              ---------                        
  109.     | for members' products.           ------|--       |              (tm)     
  110.     | Please write to the           --|         |      |------------------     
  111.     | ASP Ombudsman at                |    -----|---   |  Association of       
  112.     | PO Box 5786,                    |   |         |--   Shareware            
  113.     | Bellevue, WA 98006               ---|    O    |     Professionals        
  114.     | or send a Compuserve          ------|    |    |---------------------     
  115.     | message via easyplex to              ---------      MEMBER               
  116.     | ASP Ombudsman 70007,3536                                                
  117. FormFill                     Starting the Program                     Quick Doc
  118.                              ====================                              
  119.     |                                                                          
  120.     |                                                                          
  121.     |  Syntax to set up field definitions is:                                  
  122.     |                                                                          
  123.     |       DEFINE filespec                                                    
  124.     |                                                                          
  125.     |  Syntax to fill in a form is:                                            
  126.     |                                                                          
  127.     |       FILL filespec /P                                                   
  128.     |                                                                          
  129.     |  where:                                                                  
  130.     |       filespec - is the name of an existing .FRM file to be loaded       
  131.     |                  on startup                                              
  132.     |                                                                          
  133.     |       /P - optional switch to be used if your system uses                
  134.     |            non-standard hardware which results in messages like          
  135.     |            "Printer Not Connected" when this is obviously not            
  136.     |            the case.                                                     
  137.     |                                                                          
  138.     |                                                                          
  139.     |                          General Procedure                               
  140.     |                          =================                               
  141.     |                                                                          
  142.     |  To use FormFill to fill in forms created with FormGen, you first        
  143.     |  define the position and type of each data field on the form.            
  144.     |  Once this is done, you can use the Fill module to fill and print        
  145.     |  the form.                                                               
  146.     |                                                                          
  147.     |  Data fields can contain any kind of information, but four different     
  148.     |  types of fields are provided:                                           
  149.     |                                                                          
  150.     |     text - may contain any textual or numeric material and may           
  151.     |            span several lines                                            
  152.     |  numeric - contain numeric information only and can be used in           
  153.     |            calculations                                                  
  154.     |     date - uses the date from the system clock, or allows a date to      
  155.     |            be entered                                                    
  156.     |     time - uses the time from the system clock, or allows a time to      
  157.     |            be entered                                                    
  158.     |                                                                          
  159.     |                                                                          
  160.     |                                                                          
  161.     |                                                                          
  162.     |                                                                          
  163.     |                                                                          
  164.     |                                                                          
  165.     |                                                                          
  166.     |                                                                          
  167.     |                                                                          
  168.     |                                                                          
  169.     |                                                                          
  170.     |                                                                          
  171.     |                                                                          
  172.     |                                                                          
  173.     |                                                                          
  174.     |                                                                         
  175. FormFill                      Cursor Movement Keys                    Quick Doc
  176.                               ====================                             
  177.     |                                                                          
  178.     |                                                                          
  179.     |    [up] - move cursor up           |  [Home] - move cursor to left       
  180.     |                                    |           edge of pad               
  181.     |  [down] - move cursor down         |                                     
  182.     |                                    |   [End] - move cursor to right      
  183.     |    [<-] - move cursor left         |           edge of pad               
  184.     |                                    |                                     
  185.     |    [->] - move cursor right        |  [PgUp] - move up one screen        
  186.     |                                    |                                     
  187.     |   [->|] - move cursor right to     |  [PgDn] - move down one screen      
  188.     |           the next tab stop        |                                     
  189.     |                                    |  [Ctrl][Home] - move cursor to      
  190.     |   [|<-] - move cursor left to      |                 upper left          
  191.     |           the next tab stop        |                 corner of screen    
  192.     |                                    |                                     
  193.     |    [F7] - move the cursor left     |   [Ctrl][End] - move cursor to      
  194.     |           to the next non-blank    |                 lower left          
  195.     |           character                |                 corner of screen    
  196.     |                                    |                                     
  197.     |    [F8] - move the cursor right    |  [Ctrl][PgUp] - move cursor to      
  198.     |           to the next non-blank    |                 top of form         
  199.     |           character                |                                     
  200.     |                                    |  [Ctrl][PgDn] - move cursor to      
  201.     |   [Ret] - move to the beginning of |                 bottom of form      
  202.     |           the next line            |                                     
  203.     |                                                                          
  204.     |                                                                          
  205.     |                        Field Definition Keys                             
  206.     |                        =====================                             
  207.     |                                                                          
  208.     |  [F1] - Define Text Field                                                
  209.     |         -----------------                                                
  210.     |  Creates a text input field at the cursor position. Use arrow keys       
  211.     |  (or the right mouse button) to strech the field to the desired          
  212.     |  dimensions and then press return.  You will then be asked for a         
  213.     |  default value for the field.                                            
  214.     |                                                                          
  215.     |                                                                          
  216.     |  [F2] - Define Numeric Field                                             
  217.     |         --------------------                                             
  218.     |  Creates a numeric field at the cursor position. The field may be        
  219.     |  entered or computed.  Entered fields will prompt for:                   
  220.     |                                                                          
  221.     |  FORMAT - format mask (see below)                                        
  222.     |  DEFAULT - default value at entry time (if any)                          
  223.     |                                                                          
  224.     |  Computed fields will prompt for:                                        
  225.     |                                                                          
  226.     |  FORMAT - format mask (see below)                                        
  227.     |  FORMULA - calculation (see below)                                       
  228.     |                                                                          
  229.     |                                                                          
  230.     |                                                                          
  231.     |                                                                         
  232. FormFill                     Field Definition Keys (cont'd)           Quick Doc
  233.                              =====================                             
  234.     |                                                                          
  235.     |                                                                          
  236.     |  [F3] - Define Field                                                     
  237.     |         ------------                                                     
  238.     |  Creates an entry field at the cursor position. Types available:         
  239.     |                                                                          
  240.     |     1) TEXT                                                              
  241.     |     2) NUMERIC                                                           
  242.     |         1) entered                                                       
  243.     |         2) computed                                                      
  244.     |     3) DATE                                                              
  245.     |         1) entered                                                       
  246.     |         2) current @ Entry                                               
  247.     |     4) TIME                                                              
  248.     |         1) entered                                                       
  249.     |         2) current @ entry                                               
  250.     |                                                                          
  251.     |                                                                          
  252.     |                              Other Keys                                  
  253.     |                              ==========                                  
  254.     |                                                                          
  255.     |                                                                          
  256.     |       [F9] - Save form definition.                                       
  257.     |                                                                          
  258.     |  [Alt][F9] - Load form & definitions.                                    
  259.     |                                                                          
  260.     |   [Alt][P] - Set path to data directory.                                 
  261.     |                                                                          
  262.     |   [Alt][X] - Exit FormFill                                               
  263.     |                                                                          
  264.     |   [Alt][Q] - Toggle cursor position display between Row/Col and          
  265.     |              vertical/horizontal inches.                                 
  266.     |                                                                          
  267.     |   [Alt][O] - Call operating system.  This loads a secondary copy of      
  268.     |              DOS, allowing files to be copied, disks formatted, and      
  269.     |              other programs to be run from within DEFINE.                
  270.     |                                                                          
  271.     |              To return to DEFINE, type EXIT at the DOS prompt.           
  272.     |                                                                          
  273.     |                                                                          
  274.     |                                                                          
  275.     |                                                                          
  276.     |                                                                          
  277.     |                                                                          
  278.     |                                                                          
  279.     |                                                                          
  280.     |                                                                          
  281.     |                                                                          
  282.     |                                                                          
  283.     |                                                                          
  284.     |                                                                          
  285.     |                                                                          
  286.     |                                                                          
  287.     |                                                                          
  288.     |                                                                          
  289.     |                                                                         
  290. FormFill                        Numeric Formats                       Quick Doc
  291.                                 ===============                                
  292.     |                                                                          
  293.     |                                                                          
  294.     |   Formats may be specified for numeric fields using:                     
  295.     |                                                                          
  296.     |      #, period (.), $ or $$, + or -, and comma (,)                       
  297.     |                                                                          
  298.     |      Example: value=1234.567                                             
  299.     |                                                                          
  300.     | ------------------------------------------------------------------------ 
  301.     |     Format    |    Output    |                  Comment                  
  302.     | ======================================================================== 
  303.     |     #####     |     1235     | leading blank, rounded to nearest integer 
  304.     |      ####.#   |     1234.6   | one decimal place                         
  305.     |      ####.##  |     1234.57  | format for money                          
  306.     | ------------------------------------------------------------------------ 
  307.     |    ##,###     |    1,235     | comma divides thousands                   
  308.     |   $##,###.##  |  $ 1,234.57  | left aligned dollar sign                  
  309.     |  $$##,###.##  |   $1,234.57  | dollar sign against first digit           
  310.     | ------------------------------------------------------------------------ 
  311.     |  $$##,###.##- |   $1,234.57  | would show trailing minus if negative     
  312.     |  $$##,###.##+ |   $1,234.57+ | shows trailing plus, (-) if negative      
  313.     | ------------------------------------------------------------------------ 
  314.     |                                                                          
  315.     |                                                                          
  316.     |                              Formulas                                    
  317.     |                              ========                                    
  318.     |                                                                          
  319.     |  Four standard math operations are available:                            
  320.     |                                                                          
  321.     |    + addition    * multiplication    - subtraction    / division         
  322.     |                                                                          
  323.     |  In addition, constant percentages are supported. (ie. 12.5%)            
  324.     |  The values of other fields are indicated by square brackets. []         
  325.     |                                                                          
  326.     | ------------------------------------------------------------------------ 
  327.     |            Formula           |                  Comment                  
  328.     | ======================================================================== 
  329.     |  [8]*[12]+7                  | [field 8] x [field 12] + 7                
  330.     |  [8]*([12]+7)                | [field 8] x the result of [field 12] + 7  
  331.     | ------------------------------------------------------------------------ 
  332.     |  [3]/2                       | [field 3] divided by 2                    
  333.     |  [28]*8.25%                  | 8.25 percent of [field 28]                
  334.     | ------------------------------------------------------------------------ 
  335.     |  [1]+[2]+[3]+[4]+[5]+[6]     | the sum of fields 1 thru 6                
  336.     | ------------------------------------------------------------------------ 
  337.     |                                                                          
  338.     |                                                                         
  339.  ----------------------------------------------------------------------------- 
  340. |     -------------------------------------------------------------------     |
  341. |    | -------=======<<<<<<< FormFill Registration >>>>>>>=======------- |    |
  342. |     -------------------------------------------------------------------     |
  343. |                                                                             |
  344. |    FormFill is a copyright program distributed on a "Shareware" basis,      |
  345. |    that is, it may be freely distributed for TRIAL use.  This gives you     |
  346. |    the benefit of being able to try it out BEFORE you buy.  If you don't    |
  347. |    find it useful, simply destroy or give away your copy and accept my      |
  348. |    thanks for giving it a shot.                                             |
  349. |                                                                             |
  350. |    If, however, you find it beneficial and wish to continue using it,       |
  351. |    please register it by completing the bottom of this form and sending     |
  352. |    the appropriate fee.  This will give you a nicely printed manual, an     |
  353. |    update of the program including any new features, and a clear            |
  354. |    conscience whenever you use the program.  If you believe in the          |
  355. |    concept of shareware, it will also give you the nice feeling that        |
  356. |    comes from knowing that you are backing up your beliefs and are          |
  357. |    helping to encourage more development of this type of distribution.      |
  358. |                                                                             |
  359. |    The registration is a very low price, but it helps us to make a          |
  360. |    living and to continue to maintain and improve the program.              |
  361. |                                                                             |
  362. |    If you do not register, but continue to benefit from the use of my       |
  363. |    program, you are clearly violating the terms of my copyright, and        |
  364. |    I will not be amused.                                                    |
  365. |                     ----------------------------------                      |
  366. |                                                                             |
  367. |     I would also be most pleased to add YOUR best forms to our library      |
  368. |     for distribution to other FormFill users.  If you send a disk with      |
  369. |     your own form designs, I will allow you a $10 discount on your          |
  370. |     registration.                                                           |
  371. |                                                                             |
  372. |     Please complete the form below and mail it today!           ░░░░  ░░░░  |
  373. |                                                                 ░     ░     |
  374. |     THANK YOU!      ...for supporting shareware!                ░░░   ░░░   |
  375. |                                                                 ░     ░     |
  376. |     Randy MacLean - FormFill author                             ░     ░     |
  377. |-----------------------------------------------------------------------------|
  378. |   Please register me as a FormFill User!  RUSH my manual and update ASAP!   |
  379. |     O I don't have any forms yet - here's my $35 registration fee.          |
  380. |     O I've enclosed a disk with my forms - my fee is $25.                   |
  381. |  -------------------------------------------------------------------------  |
  382. | | Name:                              | Company:                           | |
  383. | |-------------------------------------------------------------------------| |
  384. | | Address:                           | City:                  State:      | |
  385. | |-------------------------------------------------------------------------  |
  386. | | Zip:             |                      +-+-+-+-+-+-+-+-+-+-+-+-+-+       |
  387. |  ------------------             -> O VISA |       |     |     |     |       |
  388. |                                |          |-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
  389. |  O Please bill my credit card -|-> O M/C  |       |       |       |       | |
  390. |  O I've enclosed my check      |          |-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
  391. |                                 -> O AMEX |       |           |         |   |
  392. |  mail to:                                 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+   |
  393. |     Randy MacLean                         +-+-+-+-+                         |
  394. |     c/o FormGen Corporation        Expiry |   |   |                         |
  395. |     #9 - 13 Holland Drive                 +-+-+-+-+                         |
  396. |     Bolton, Ontario                For faster service, phone (416) 857-0022 |
  397. |     L7E 1G4                                            FAX   (416) 857-4531 |
  398.  ----------------------------------------------------------------------------- 
  399.